home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / misc / unix / uae_0_4_3_tar_gz.readme < prev    next >
Text File  |  1996-03-19  |  8KB  |  145 lines
  1. Short:    Version 0.4.3 of UAE, the Un*x Amiga Emulator
  2. Author:   Bernd Schmidt
  3. Uploader: Santagostino Carlo <santagos@dsi.unimi.it>
  4. Type:     misc/unix
  5.  
  6. now is USABLE!!!
  7. Emulates a full Amiga 500 (blitter, copper, drives etc.)
  8. full speed on a P166 (or a DEC ALPHA, SGI, HPUX etc.)
  9. Need kickstart ROMS.
  10.  
  11. --------------------------------------------------------
  12. This is version 0.4.3 of UAE, the Un*x Amiga Emulator.
  13.  
  14. 1. <drivel.h>
  15.  
  16. Copyright 1995, 1996 Bernd Schmidt & contributors (see below). This program is
  17. freeware.  You may do whatever you want with it for personal use. Permission
  18. is granted to call it a simulator if it makes you happy and you can give me a
  19. satisfactory explanation why "simulator" and "emulator" are not synonyms.
  20. Permission is granted to redistribute this program free of charge, provided it 
  21. is distributed in the full archive with unmodified contents and no profit 
  22. beyond the price of the media on which it is distributed is made. Exception: It
  23. may be included on freeware/shareware collections on CD-ROM.
  24. There are no warranties of any kind for this program. If you use this program,
  25. you do so at your own risk. The authors are not responsible for any damages 
  26. that might result from using this program.
  27. This program is still in an early development stage. It contains bugs and is
  28. not user-friendly. 
  29.  
  30. 2. What you need to get it to work
  31.  
  32.   - a Un*x system with the X Window System, or, if you use Linux, SVGAlib.
  33.     X is much more stable and not that much slower, so use X if possible.
  34.     SVGAlib can get your system into an unusable state if it crashes. You
  35.     have been warned.
  36.   - A graphics card that lets you use a resolution of at least 800x600 in
  37.     65536 colors. You can compile UAE for 256 color screens, but the colors
  38.     will not be quite as good.
  39.   - a C compiler. An _ANSI_ C compiler. What most workstation vendors ship
  40.     is not a compiler, but a nightmare. Use GCC if it is available.
  41.   - A Kickstart ROM file. I've heard success reports with Kickstart 1.3, 2.0,
  42.     3.0 and 3.1 from various people.
  43.     There seem to exist special 68020+ versions of newer Kickstarts. These 
  44.     will not work, neither will EPROM versions, and neither will ZKick files.
  45.     Please do not ask me to send you one. The Kickstart is copyrighted, and I
  46.     can't pass it around.
  47.     This version of the emulator can boot some programs even without a
  48.     Kickstart. See below for more information.
  49.  
  50. I've successfully tested UAE on the following systems:
  51.   - Pentium-90, Linux 1.3.45; X11R6 (XFree86 3.1.1) / SVGAlib 1.2.9, GCC 2.7.2
  52.   - HP Apollo, HP-UX, X11R5, GCC 2.6.0
  53.   - Sun Sparcstation, Solaris, OpenWindows, GCC 2.6.1
  54.  
  55. Several people have successfully run previous versions on a variety of
  56. systems, including a SGI Indy, Suns, a DEC Alpha and a m88k based Unix box.
  57.  
  58. 8. Current state of UAE
  59.  
  60. The following parts are already mostly complete:
  61.   - MC68000 CPU: Almost done, some rare instructions are not emulated yet. 
  62.     I'd like to make this a 68020 emulation, but I need more info than I have
  63.     about the special registers (MMU etc.)
  64.     Maybe it will one day run Linux/68k!
  65.   - Blitter: If there's no bug, it ought to be complete.
  66.   - Timers: I think these are fully working, too.
  67.   - Copper: Not much to emulate here :-)
  68.   - Floppy disk: Standard AmigaDOS disks seem to work O.K., some special
  69.     formats can be made to work (not yet really supported).
  70.   - Playfield (display) hardware: Normal cases are working, as well as
  71.     dual playfields, EHB and HAM and interlace (interlace only with correct 
  72.     aspect)
  73.   - Mouse, Keyboard, Joystick: Mouse and joystick should be autocalibrating.
  74.     Only DE and US are supported as keyboard languages.
  75.   - Sprites: Still one or two bugs, but usually working.
  76.   - Sound: Some support (Linux only). Not too useful right now. See below.
  77.  
  78. Not done:
  79.   - "System control hardware": That's what the HRM calls sprite/playfield
  80.     collisions/priorities. Only the most common priority settings are
  81.     implemented.
  82.   - Timing: It does not really behave like a real A500, but I don't think
  83.     complete accuracy is necessary.
  84.  
  85. 9. Input devices
  86.  
  87. Mouse, keyboard and joystick can be used in a straightforward way. Two
  88. keyboard languages are supported right now: german and US keyboard. If you
  89. have a different keyboard, patches to make UAE work with it are appreciated.
  90. The X version of the emulator will try to keep the Amiga mouse pointer at the
  91. same location as the X mouse pointer. You can turn off this mode if it does
  92. not work with your program by pressing F12. This is needed (for example) for
  93. Lemmings and the Magnetic Scrolls adventures, which don't use sprite 0 as a
  94. mouse pointer. The SVGAlib version does not have this problem.
  95. If you use Linux and have the joystick driver kernel module, you can configure
  96. UAE to use it. The joystick should be autocalibrating. Turn it a few times on
  97. startup to get the calibration done. 
  98.  
  99. 10. Sound
  100.  
  101. You probably noticed the LINUX_SOUND configuration option. If defined, this
  102. will make the emulator use /dev/dsp to output sound with 16 bit, at a frequency
  103. of 44100KHz. Your soundcard has to support this rate. If it does not, your
  104. results will be unpredictable.
  105. If graphics output is enabled while sound is output, the emulator will be much
  106. too slow on all current systems. The sound will not be continuous. Therefore,
  107. a hack to turn off screen updates is provided: Press ScrollLock to disable
  108. graphics, press it again to enable them (note: for X, you'll have to press it
  109. twice each time).
  110. The LINUX_SOUND_SLOW_MACHINE option will steal cycles from the CPU emulator.
  111. The relative CPU speed will be reduced somewhat if this option is set. This may
  112. lead to incompatibilities. The system should not be heavily loaded (no blitter
  113. or disk activity) while sound is being played, or even this will be too slow.
  114. Only a subset of the Amiga sound hardware is emulated. Attached channels are
  115. not implemented, neither is CPU-driven output.
  116.  
  117. Currently, this implementation is good enough to play *Tracker modules and
  118. some game title melodies. It is fast enough (on a P90, without the
  119. LINUX_SOUND_SLOW_MACHINE option) to play modules using a Workbench player
  120. program if no other (Amiga) processes are active. 
  121.  
  122. On other Unix systems, the AF sound system may be available. You can configure
  123. UAE to use this, too, by changing some paths in the Makefile.
  124.  
  125. 11. Speed
  126.  
  127. A Pentium with about 500MHz would be nice... (*)
  128. but even a Pentium-90 is not that bad, if you set the frame rate to a high
  129. value, e.g. 9. Animations will not be smooth if not all frames are drawn, but
  130. the speed of the emulation will be considerably higher.
  131. The speed of the emulation is not fixed. Programs that make heavy use of 
  132. blitter, copper and disk DMA will run somewhat slower than programs that only
  133. use the CPU. More bitplanes and sprites will also slow things down. The speed
  134. also depends very much on configuration options.
  135. UAE can calculate the average time it needs to finish one Amiga frame. Use the
  136. 'c' debugging command. If you use SVGAlib, the average frame rate will be
  137. displayed when you exit UAE, provided the library doesn't mess up your
  138. text-mode screen when you exit.
  139.  
  140. There used to be a table here with speed comparisons, but it was getting
  141. constantly out of date. Short summary: A Pentium-90 will be 4-5 times slower 
  142. than a real A500 at full frame  rate. If you reduce the frame rate, it is only 
  143. about 2 times slower. It can achieve full speed for sound output if graphics
  144. are turned off (useful for module players).
  145.